═══ 1. Introduction ═══ RPF Zip Control(TM) Copyright 1993-1996 RPF Software All Rights Reserved Zip Control is a OS/2 32-bit threaded PM program which provides "point & click" access to Zip and UnZip. Info-ZIP's freeware programs Zip.exe and UnZip.exe are used by many OS/2 users to manage .zip archives. Zip and UnZip are command line programs which create and unzip archive files which are compatible with the PKWare PkZip and PkUnZip 2.04g programs. Additionally, the Info-ZIP programs support OS/2's long file names and extended attributes. Zip Control features:  View the list of files contained in a .zip file.  View the contents of one or more files which are contained in the .zip file. The "view" function respects the WorkPlace Shell "associations."  Print a contained file, including 2-up printing.  Sort contained files by a combination of date, name, and path.  Find and highlight files based on search text.  Extract one or more files, define target directory during extract.  Drag and drop files from .zip file to folder or Desktop.  Drag and drop files and/or folders from Desktop and folders to Zip Control to create or add to .zip file or to open the .zip file.  Delete selected files from archive.  Add one or more files to archive.  Change default extract or add options/modifiers at action time.  Configuration notebook.  Simple, easy format with all choices displayed. No learning curve.  Optional expert mode with reduced window size (just list of files), use accelerator keys and/or pop-up menu.  On-line help.  Numerous ease of use features.  Search multiple disk drives and list all .zip files, sort by name, date, and/or path to assist in disk and archive management. Delete or open .zip files from sorted list.  QwikEval: test, extract to temp dir, virus scan & report, re-zip. Test run or run install programs, then delete temp dir.  Supports encrypted files--both view/unzip and create.  No changes to Config.sys. Private .ini file in product directory.  Includes an Install program.  AutoUnZip permits dragging a .zip file to an icon and auto-UnZipping the file to a pre-determined directory structure, without displaying Zip Control.  Able to restrict Zipping to files modified after a specified date.  Interactively (Ctrl-T, Ctrl-S) or automatically (AutoTest, AutoScan) "Test" and/or virus "Scan" open .zip files.  Review Extended Attributes (EAs) added by Golden CommPass.  "Hints" in status bar.  IBM, McAfee, and other virus scanner support. UnZip and Zip are available as freeware on many BBSs which have OS/2 libraries, at many Internet sites, on-line services, and other locations. See the ReadMe.doc file for specific locations. Zip and UnZip are freeware products of Info-ZIP. Zip Control is a copyrighted software product of RPF Software. Info-ZIP and RPF Software are independent organizations. Zip Control only works with the OS/2 versions of Zip.exe and UnZip.exe, versions 2.01 and 5.1 (or higher), respectively. Future updates to Zip Control may be available at the sites specified in the ReadMe.doc file. Zip Control is copyrighted software, it is NOT PUBLIC DOMAIN, it is NOT FREE. You are encouraged to use an Evaluation copy of it for a reasonable evaluation period (21 days) to see if it is software which is helpful to you and which you wish to continue using. If you do decide to continue using Zip Control, you MUST license Zip Control by filling out the form in Order.doc and sending it along with the license fee or payment information to RPF Software or to one of the other organizations from which you can license Zip Control. See the Order.doc file or on-line help (Product Information). ═══ 2. Installation ═══ Zip Control Installation. See the Install.doc file for installation instructions. ═══ 3. Settings ═══ The Settings notebook includes pages which contain the settings for:  Options - General Defines default options for Zip Control.  Options - UnZip Defines default options used when unzipping.  Options - Zip Defines default options used when zipping.  Options - QwikEval Defines default options used when using QwikEvalt.  Paths Defines default paths.  Programs Defines the zip, unzip, default view, and virus scan programs. ═══ 3.1. Options - General ═══ The Options - General page of the Settings notebook defines default options used by Zip Control.  "Hide buttons (expert)" will hide all of Zip Control's main window except for the title bar and the list box. The main window will be resized to be the same size as the list box. The window (and list box) will be re-sizable. When "Hide buttons" is active, less Desktop space will be used. Use the "accelerator keys" to perform Open, New, etc., or use the pop-up menu. The pop-up menu (right mouse button click in the Zip Control window) shows the available accelerator keys. The accelerator key "Ctrl-H" toggles between the minimized "expert" mode and the standard Zip Control main window.  "Minimize active window while processing" causes the active window, e.g., the UnZip window, to be minimized while the unzip is in process. A small progress window will be displayed in a corner of the screen. This frees up screen "real estate" during long processing, e.g., large zips or unzips. Once the process completes, the active window, if minimized, will be restored to the size and location it was before being minimized.  "Display progress window even if not minimized" forces the progress window to be displayed during an "action" even if the action window is not to be minimized during processing.  "Extended selection" sets the default list box selection mode to Extended. Otherwise, the selection mode is Multiple. "Extended" selection allows the selection (highlighting) of one or more than one lines in a list box by dragging the mouse over those entries while mouse button one is depressed. Single entries can be selected or deselected by clicking the left mouse button while depressing the Ctrl key. "Multiple" selection allows the selection of multiple list box entries by making left mouse button clicks, one at a time, on the list box entries. Select a highlighted entry again to deselect it.  "SmartView" sets the default View operation of Zip Control to use the Work Place Shell's associations to determine how to View a file contained in a zip file. For example, text files and icon files are associated with the System Editor (E.Exe) and the Icon Editor (IconEdit.exe), respectively, in the default OS/2 installation. These WPS associations can be changed by editing the entries on the Associations page of WPS objects. In the example above, with SmartView enabled, a request to View a file which has a .ico file extension will display that icon file using the Icon Editor (IconEdit.exe). This is the same way that the file would be viewed if opened from the WPS or from the Drives object. With SmartView disabled, the View command will use the View program defined on the Programs page of the Zip Control Settings notebook. This feature is handy in viewing a text file which has, as its file extension, an extension that the WPS would incorrectly interpret. An example would be a file with a .inf extension which is a text file, not a file to be viewed with the OS/2 program View.exe.  "LaserJet 2-up" sets the default Print option to use the LaserJet 2-up printing capability. This option prints two pages of a text file on each page of paper, side by side. Additionally, a header and footer is printed on each page.  "AutoOpen" automatically opens the file open dialog box when Zip Control is started.  "AutoComments" automatically opens the Comments window, if the zip file contains archive comments or certain extended attributes (EAs).  "AutoTest" automatically tests each zip file when it is "opened". The test is for zip file integrity (or corruption), using the UnZip -t option.  "AutoScan" automatically virus scans each zip file when it is "opened". This requires that a virus scan program be defined in the Settings notebook, Programs page. AutoScan can be particularly helpful since easy Internet access to files that may not have been virus scanned (such as in "/incoming/" directories) increases virus risk.  "Save colors/fonts" sets the default for each window to save the colors and fonts used for that window. This allows customization of the colors and fonts on a window by window basis, using OS/2's drag and drop of colors and fonts (or color schemes) to Zip Control's windows or window components, e.g., background color or push button font.  "Reset Colors/Fonts" will remove ALL previously saved Zip Control window colors and fonts. The result is that Zip Control will revert back to using the color scheme which is active for OS/2. The default settings above may be individually overridden (within the appropriate window). ═══ 3.2. Options - UnZip ═══ The Options - UnZip page of the Settings notebook defines default options used when unzipping.  "Move .Zip file to repository after unzipping". If checked, the .zip file will be moved from its current directory to the directory defined in the Settings Notebook, "Repository directory for .Zip files after unzipping" field. This is helpful in keeping the downloaded files organized. The files which haven't yet been unzipped will be in the download directory. The files which have been unzipped will have been automatically moved to a "repository" for such files.  "Put files in a subdir (= file name) of .Zip location". This is one convenient way to organize your downloaded files. This option creates a subdirectory of the directory in which the zip file is located. The name of the subdirectory will be the same as the zip file name (without the extension). For example, if the download directory (default zip file location) were C:\Download and the file Tools.zip had been downloaded to C:\Download, then Zip Control would create the directory C:\Download\Tools and place the contents of Tools.zip in that directory. (This option and the Use Zip Location option on the Paths page of the Settings notebook are mutually exclusive.)  "Respect" the stored path(s) in the zip file (or not). "Respect" (the default and recommended), when checked, will unzip the files in the zip file to the target directory, create (if necessary) the relative paths (directories) as subdirectories to the target directory, and properly place the unzipped files in the correct subdirectories. When "Respect" is NOT checked, the files in the zip file will be placed in the target directory . . . even if the intended file paths had been stored in the zip file.  "Update" existing files and create new ones as needed. "Update" will, during the unzip process, replace existing files of the same name in the target directory IF and ONLY IF the files in the zip file have a later creation date than the same-named files in the target directory. "Update" will also, during the unzip process, unzip any files in the zip file which are not in the target directory.  "Freshen" existing files, but do not create new files. "Freshen" will perform as "Update" (above) does but WILL NOT unzip any files in the zip file which are not in the target directory. "Freshen" is not compatible with the "Never overwrite" option, since "never overwriting" existing files and not unzipping files which do not exist in the target directory leaves nothing for UnZip.exe to do. "Update" and "Freshen" are mutually exclusive selections. With neither "Update" nor "Freshen" selected (the default and recommended), the files ("Selected" or "All") in the zip file will be unzipped to the target directory, REPLACING any existing files of the same name, regardless of file creation date, and also unzipping files which do not currently exist in the target directory . . . subject to the "Never overwrite" option.  "Never overwrite" existing files. "Never overwrite" will prevent UnZip.exe from unzipping files from the zip file which already exist in the target directory.  "Don't make names lower case." "Don't make names lower case" will prevent UnZip.exe from converting to lower case, file names which were originally stored as upper case on a DOS system.  "Report 'UnZip' error > than:" defines the error level at which Zip Control will report a possible error. UnZip reports the errors described in the UnZip.doc file. Error "0" means no errors detected. Error "1" implies warnings of non-fatal irregularities. Error "2", unfortunately, can include both warnings and fatal errors. Zip Control defaults to reporting "UnZip" errors above "2". The default settings above may be individually overridden (within the UnZip window) when performing each unzip. ═══ 3.3. Options - Zip ═══ The Options - Zip page of the Settings notebook defines default options used when zipping.  "Store path(s)" will store the proper path (directory) names in the zip file, relative to the highlighted directory. If you have selected several files from the "File" list, those files will be zipped, stored with the beginning path being the highlighted path in the "Directory" list. If you have selected (highlighted) a directory with the "Select Directory" button, all the files in the directory will be zipped, if All Files is checked; otherwise, just the directory name will be stored. If All Files is checked and Store Path is checked, then the directory name along with all its files will be stored.  "Zip all subdirs too" zips all files in the selected directory plus all the files in its subdirectories. In most cases you should also select "Store path(s)" so that Zip can resolve zipping two files with the same file name. If you are certain that no two file names in the highlighted directory and its subdirectories have the same name, "Store path(s)" is optional.  "Store path of selected dir" will use the path of the selected directory as the "top level" directory when "Store path(s)" is selected. Normally (unchecked), directory names will only be stored for the files in the subdirectories of the highlighted directory.  "System/Hidden files" - Files with the system and/or hidden file attribute are displayed in the file list, but are not stored in the zip file unless this item is checked.  "Freshen" - If the file to be added to the zip file is already in the zip file AND is newer than the one in the zip file, the newer file will replace the one in the zip file. The file will be added ONLY IF there is already a file by that name (and path) in the zip file.  "Update" - This is the same as "Freshen" except that, if the file is not already in the zip file, it will be added to the zip file.  "Grow (faster/risky)" - Normally Zip adds files to a temporary file, and if that completes successfully, it deletes the old zip file (if any) and renames the temporary file to the old name. This has some added safety at the expense of slightly slower processing time and using more disk space temporarily. The Grow option can be use to dynamically extend an existing zip file. If all goes well, then everything will be fine. However, if OS/2 is stopped due to a power outage (or some other problem), then the integrity of the "in process" zip file would be suspect.  ".Zip date = latest file" - The file date of the zip file will be changed to match the date of the newest file in the zip file.  "Compression" can be adjusted, by using the spin buttons, to set a value from 1 (the fastest compression mode->larger .zip files) to 9 (the slowest compression mode->smallest .zip files). The default is 9. ═══ 3.4. Options - QwikEval ═══ The Options - QwikEval page of the Settings notebook defines default "Auto" options for the QwikEval window.  "Test", when checked, will auto-run UnZip's "Test" function against the currently open zip file, when QwikEval starts.  "Extract", when checked, will cause the contents of the zip file to be extracted to a temporary directory for possible scanning and for file review, automatically after the Test operation has competed. The directory containing the extracted files will appear on the Desktop. This will allow you to run an Install program or to "test run" the program.  "Scan" causes the Scan function to be automatically started against the files Extracted to the temporary directory, after Extract completes. Upon the completion of the Scan, a report will be displayed listing the results of the Scan.  "ReZip" is automatically run after Comments completes. This will rezip the contents of the temporary directory at the maximum compression, with stored paths, and with the any new comments, to the new file name supplied.  "Delete", when checked, will automatically delete the temporary QwikEval directory, upon Exit.  "Exit" is performed automatically after the ReZip or Delete is completed. If Exit is explicitly selected, and if Delete is set to Auto, the QwikEval temporary directory will be deleted prior to Exiting.  "Report 'Test' error > than:" defines the error level at which Zip Control will report a possible error. The UnZip "Test" option reports the errors described in the UnZip .doc file. Error "0" means no errors detected. Error "1" implies warnings of non-fatal irregularities. Error "2", unfortunately, can include both warnings and fatal errors. Zip Control defaults to reporting any "Test" errors above "1". ═══ 3.5. Paths ═══ The Paths page of the Settings notebook defines default paths used by Zip Control.  Directory where zip files usually are. Set this path (drive and directory) to where you normally download zip files.  Directory into which zip files are usually unzipped. Set this path (drive and directory) to where you usually want zip files unzipped.  The option to, by default, unzip files into the same directory in which each zip file is located (rather than using the default output directory).  Working directory for Zip Control. Set this path (drive and directory) to a directory on a disk drive which has significant free disk space. This working directory is used for the temporary files created by Zip.exe and Zip Control. Note: A subdirectory, ~ZipWork, of the work location directory is used for Zip Control temporary files created when using "View", "Print", "New", "Add", and "Delete". The temporary files should be automatically cleaned up by Zip Control. However, if they are not automatically deleted, you may delete them at any time. The temporary files should all be located in the ~ZipWork subdirectory. Since the work location directory will be used to create potentially large temporary files, select a path (drive and directory) which has significant free disk space.  Repository directory for .Zip files after unzipping. This directory will store .zip files which have been unzipped. The .zip files in the download directory will be moved here after unzipping IF the "Move .Zip file to repository after unzipping" option is checked on the Options, UnZip page of the Settings Notebook. ═══ 3.6. Programs ═══ The Programs page of the Settings notebook defines programs used by Zip Control.  The name, and optionally path, of the Zip program. This program is usually named Zip.exe and is usually found in an archive named Zipnnn.zip or Zipnnnc2.zip.  The name, and optionally path, of the UnZip program. This program is usually named UnZip.exe and is usually found in a self-extracting archive named UnZnnn.exe or UnZnnnx2.exe.  The name, and optionally path, of the UnZipSFX program (a Zip2EXE-type file, found in the UnZip archive set). This file, UnZipSFX.exe, is a file which is used by Zip Control to build a self-extracting archive, i.e., convert a zip file to an .exe file that can then be "self-extracted" by just "running" the .exe file in an OS/2 session or from the Desktop. The full path (drive, directory, and file name) is required IF UnZipSFX.exe is not in a directory which is included in the PATH statement in the Config.sys file. The UnZipSFX.exe file is included in the self-extracting archive which included UnZip.exe. This archive is usually named UnZnnnx2.exe or UnZnnn.exe, where nnn is the latest version of UnZip.  The name, and optionally path, of the program with which you wish to view files stored within the zip file when not using the SmartView feature. This could be the E.exe or EPM.exe editors which come with OS/2 or another editor or viewer, such as List.exe could be used. The viewer entered in this entry field will only be used in those cases where the SmartView feature is (usually temporarily) disabled, e.g., to "view" an OS/2 cmd file. The method in which the view program is started may be customized ("Custom"). This may be helpful for DOS or OS/2 "viewers" which need to be forced to Full Screen or Windowed. This option is not normally needed.  The full path and name of the OS/2 program to use to scan for viruses. The virus scanning feature is found in QwikEval. Default settings are built into Zip Control for the McAfee and IBM AntiVirus virus scanners. If non-default McAfee or IBM AntiVirus options are desired or if a virus scan program other than McAfee or IBM AntiVirus is to be used, select the Custom button to enter the custom parameters.  See Virus Scan Program Custom Parameters ═══ 4. Open ═══ The Open button is one of several methods to make a specific zip file the "active" zip file. Once a zip file is "active," the list of files contained in the .zip file are listed in the "Zip File Contents" list box. The other methods of "activating" a zip file are:  Dragging a zip file from the Desktop or a Drives folder to the Zip Files list box of the main window of a running Zip Control WHILE keeping the Shift and Ctrl keys pressed immediately prior to releasing the mouse button.  Dragging one or more zip files from the Drives container (or the Desktop) to the Zip Control desktop program reference object.  Starting the ZipCntrl.exe program from the command line, e.g., ZipCntrl.exe MyFile.zip  Double clicking on a .zip file from the Drives container (or the Desktop), if "*.zip" has been "associated" with Zip Control. The File Open Dialog Box The file open dialog box initially lists the *.zip files in the directory defined in the Settings notebook, Paths page, which describes the default location for zip files. Only files which have a .zip extension are listed. If you want to display a list of self-extracting (zip format) archives, change the "filter" in the Open filename entry field to "*.exe" and press the Enter key or click on the OK button. After selecting a zip archive, the file open dialog box will close, the title of the main window will be changed to reflect the name of the zip file, and the list of files contained in the zip archive will be displayed in the Zip File Contents list box. Zip Control "remembers" the last path (drive and directory) where you opened a zip file and will use this for the next Open (during that Zip Control session). AutoTest and AutoScan options in the Settings notebook, Programs page, cause Zip Control to automatically test for zip file corruption and scan for virus-infected programs each time a zip file is "opened". Note: If the AutoOpen option is selected, then Zip Control will automatically open the file open dialog box when started. ═══ 5. UnZip ═══ "UnZip" acts on highlighted (Selected) files in the list box (from the zip file) or ALL files. You first have an opportunity to override the defaults listed in Settings, Options - UnZip and Settings, Options - Paths and to override the target directory. The target directory will be created if it does not exist. A progress indicator is provided. Also, the output path may be temporarily "for this session only" changed to either the default output path, the last output path, or the path where the zip file is located. For ease in selecting previous target paths, the last ten target paths are stored in the "Output path history." The list of previous target paths is accessible from the "down arrow" to the right of the Output path entry field. If you are unzipping a password-protected file, you will be asked to enter the password used by the person who originally created the zip file. See also:  Settings notebook, Options - UnZip for explanations of the UnZip options that may be selected.  Progress window  User preferences Save/Reset colors/fonts ═══ 6. Zip ═══ When Zip Control is started, there is no active zip file. To create a new zip file, choose New. If the Add button is pressed when there is no currently "Open" zip file, New will be called automatically. You can tell which zip file is in use (or active) by the zip file name in the title bar. Several choices are available to Zip files (to add files to a new or existing zip file).  New creates an empty zip file and makes it the active zip file.  Add adds selected files to the active zip file. The active zip file may be an existing or new zip file.  Delete deletes selected files from the active zip file.  Save To saves the active zip file to a new file name (creates a new copy). Drag and Drop allows dragging files from the Desktop or a Drives folder to Zip Control's main window list box. One or more folders and/or files may be dragged at one time. The default drag mode is to zip a folder's files and the files in its subdirectories, storing the path name for any files in subdirectories, but not storing path names for files that are in the top level directory (the directory "dragged"). Pressing the Ctrl key while dragging and dropping will store the path name with the files for both the files in the subdirectories and those in the top level directory. Pressing both the Ctrl and Shift keys while dragging and dropping will result in no path names being stored, UNLESS a file only (no directories/folders) is being dragged, in which case, the zip file will be "Opened". ═══ 6.1. New ═══ Zip Control opens with no active zip file. Choose "New" to begin building a new zip file. If you wish to create a new zip file while another zip file is being displayed in Zip Control, press the "New" button, and a new, empty zip file (and empty list box) will be created. You will be asked to name the New zip file. "New" will automatically choose "Add" to add files to the new zip file. ═══ 6.2. Add ═══ An entire directory or selected files may be added to the "Selected" list. As you add each selection to the list, the "Encrypt, "Store path", "Store path of selected dir", "Subdirectories", "Freshen", "Update", "System/Hidden", "Grow", ".Zip date", "After date:", and compression speed choices will be applied to the selected files and directories. Additions may be made to a New zip file or to an existing (and already "Open") zip file. Note: Choose the options that you wish to use BEFORE selecting files or directories to be added to the zip file. You will notice that your chosen options will be included in the list of files to be zipped. Choose options first, THEN choose files and directories.  "Encrypt" stores a password in the zip file being created or modified. The password you supply will be required by anyone attempting to unzip the files that you are adding to the zip file.  "Store path(s)" will store the proper path (directory) names in the zip file, relative to the highlighted directory. If you have selected several files from the "File" list, those files will be zipped, stored with the beginning path being the highlighted path in the "Directory" list. If you have selected (highlighted) a directory with the "Select Directory" button, all the files in the directory will be zipped, if All Files is checked; otherwise, just the directory name will be stored. If All Files is checked and Store Path is checked, then the directory name along with all its files will be stored.  "Store path of selected dir" will use the path of the selected directory as the "top level" directory when "Store path(s)" is selected. Normally (unchecked), directory names will only be stored for the files in the subdirectories of the highlighted directory.  "Zip all subdirs too" zips all files in the selected directory plus all the files in its subdirectories. In most cases you should also select "Store path(s)" so that Zip can resolve zipping two files with the same file name. If you are certain that no two file names in the highlighted directory and its subdirectories have the same name, "Store path(s)" is optional.  "System/Hidden files" - Files with the system and/or hidden file attribute are displayed in the file list, but are not stored in the zip file unless this item is checked.  "Grow (faster/risky)" - Normally Zip adds files to a temporary file, and if that completes successfully, it deletes the old zip file (if any) and renames the temporary file to the old name. This has some added safety at the expense of slightly slower processing time and using more disk space temporarily. The Grow option can be use to dynamically extend an existing zip file. If all goes well, then everything will be fine. However, if OS/2 is stopped due to a power outage (or some other problem), then the integrity of the "in process" zip file would be suspect.  ".Zip date = latest file" - The file date of the zip file will be changed to match the date of the newest file in the zip file.  "After date:", when checked, will zip (add) files which have been modified after (00:00am) the date specified. Compression can be adjusted, by dragging the slider button, from 1 (the fastest compression mode->larger zip files) to 9 (the slowest compression mode->smallest zip files). The default is 9, but can be changed in the Settings notebook, Options - Zip page. Once files have been added to the "Selected" list, they may be highlighted. Files selected (highlighted) when the "Delete" button is pressed will be removed from the "Selected" list. Files are not actually zipped and added to the zip file until the "OK" button is pressed. "Comments" - This selection allows you to add comments to the zip file. After this selection is made, any current comments for the file will be displayed. These may be changed or deleted or additional comments added. Optionally, a previously prepared comments file may be "imported" at the point where the cursor is located. "Cancel" - All proposed additions to the zip file and comment changes are cancelled. "OK" - begins the Add process. All directories and files in the Selected list will be added to the zip fle regardless of whether they are highlighted or not. Depending on the number of files to be added, this may be a quick or slow process. A progress window will be displayed. See also:  Settings notebook, Options - Zip for explanations of the "Freshen" and "Update" options that may be selected.  Progress window  User preferences Save colors/fonts ═══ 6.3. Delete ═══ Use this selection to delete selected files from an existing zip file. A confirmation is required. ═══ 6.4. Save To ═══ An existing zip file will be saved to a name you select. Save To will not replace or rename an existing zip file, but will create a copy of the existing file with the new file name. As an example, if the current file is "Backup.zip", Save To may create a new file "110393.zip" (a copy of Backup.zip), but leave Backup.zip as it was. This will allow you to safely delete and add files to the new zip file without harming the original zip file. Save To has to be done prior to the deletion and addition since those choices perform immediate deletion and addition to the current zip file. ═══ 7. View ═══ View passes ALL highlighted files in the list box to the default View program (E.EXE, LIST.EXE, etc.) defined in the Programs page of the Settings notebook (if SmartView is "off") or to the editor which is "associated" with that type of file within OS/2 (if SmartView is active). Several files can be viewed at the same time. The default viewer may be helpful for viewing files which, as an example, have an .INF file extension, but are actually plain text files. The "defined viewer for that type file" will be determined by the "association" set via the Work Place Shell (if SmartView is active) or via the Zip Control Settings Notebook if SmartView is "off." ═══ 8. Print ═══ "Print" presents a listing of the files which have been highlighted. These files can be left selected (for printing) or not (will not be printed). Then the files will be printed to the printer which is selected from one of the installed printers. Simple LaserJet 2-up printing is an option. ═══ 9. Comments ═══ "Comments" displays the embedded zip file comments, if present, and/or the associated extended attributes (EAs), if present. Embedded zip comments are optionally placed in the zip file by the person or organization that creates the zip file. The comments may contain descriptive, source, or copyright information. Golden CommPass, a very useful CompuServe off-line reader and download tool, optionally adds extended attributes to each downloaded zip file. The EAs include Subject, Key Phrases, Comments, and History. If you use Golden CommPass and have enabled this option (Options, Settings, Catalogs, "Save download description in EA"), Zip Control will display them in the Comments window. To switch between the display of embedded comments and EAs, select Show EAs or Show Comments with the mouse or use the keyboard shortcuts, "E" or "C". Note: If the "AutoComments" box is checked, comments (if any) stored in the zip file and/or extended attributes (if any) will automatically be displayed. ═══ 10. QwikEval ═══ "QwikEval" provides a temporary work space where an already "Opened" zip file may be "tested" for zip file integrity, "extracted" to a temporary directory, its contents "scanned" for viruses, and the virus "report" displayed. Additionally, "QwikEval" may be used to "test run" the contents of the zip file or the contents of the zip file may be "rezipped" at a greater compression. The capabilities of QwikEval are useful to SysOps of BBSs and online forums.  "Test" invokes UnZip's -t option to test the integrity of the zip file and its contents.  "Extract" extracts the zip file contents to a temporary directory (after first deleting any prior contents of that temporary directory) and then opens a folder on the Desktop containing those files. This permits a test run of any programs in the temporary directory. This is also helpful for those zip files which expect the contents to be extracted to a temporary directory in order to be installed. Once the product installation is completed, the temporary directory (and its contents) would then be deleted.  "Scan" is used to virus check the contents of the zip file. It first extracts the contents of the zip file to a temporary directory. Then the virus scan program defined in Settings, Options - Programs is run against the files. The virus scan report is then displayed for review.  "Comments" adds ad hoc or pre-defined comments to the archive.  "ReZip" will automatically rezip the zip file contents, using maximum compression. This may be useful for BBS and online forum SysOps who want to minimize disk storage requirements and download time.  "Delete" removes the temporary directory and its contents from the hard drive and from the Desktop.  "Exit" leaves QwikEval and returns to the main Zip Control window. Note: "Auto" - When one of the QwikEval selections is completed, the next QwikEval selection is automatically performed if the box next to the selection is checked. This can speed use of QwikEval. Additionally, if the Auto box next to the Delete button is checked at the time that Exit is selected, the temporary extraction directory will be automatically deleted. Default "Auto" selections are Extract and Scan. The default "Auto" selections can be changed in the Settings notebook. ═══ 11. Search ═══ "Search" is used to build a list of all zip files on one or more disk drives. The list of files is sorted by name+date+path, path+name+date, or date+name+path. This sort order may be changed at any time, without necessitating a re-search of the disk drives. If "Ascending" is checked, then the sort will be in ascending order, otherwise it will be in descending order. Individual files in the list may be selected for either deletion (perhaps duplicates) or opening (unzipping). All the other Zip Control capabilities are available for zip files "opened" from the Search window. ═══ 12. User Preferences ═══ User preferences are "remembered" from session to session. The user preferences below, can also be changed several times within one session, without affecting the "remembered" default settings.  SmartView  AutoComments  AutoOpen  Extended Selection  Colors/Fonts ═══ 12.1. SmartView ═══ SmartView allows Zip Control to use the Work Place Shell settings (associations) to determine which editor (or other program) to use to display (or run) a file contained in a zip file when the View button is clicked. The default SmartView setting is defined in the Settings notebook, Options - General page. ═══ 12.2. AutoComments ═══ AutoComments automatically opens the Comments window, if the zip file contains archive comments or has certain extended attributes (EAs) attached. The default AutoComments setting is defined in the Settings notebook, Options - General page. ═══ 12.3. AutoOpen ═══ AutoOpen automatically opens the file open dialog box when Zip Control is started. The default AutoOpen setting is defined in the Settings notebook, Options - General page. ═══ 12.4. Extended Selection ═══ Extended Selection enables that mode of selecting files from the Zip File Contents list box. With this mode active, you may press the mouse button and drag the mouse across multiple file names, selecting them all as you drag the mouse. The default Extended Selection setting is defined in the Settings notebook, Options - General page. ═══ 12.5. Colors/Fonts ═══  Save Colors/Fonts, when selected, will save any color or font changes made to Zip Control. These changes are usually made by opening the System Setup Color, Scheme, and/or Font programs and dragging and dropping specific colors, schemes, and/or fonts on Zip Control windows or objects. The default Colors/Fonts setting is defined in the Settings notebook, Options - General page.  Reset Colors/Fonts, when pushed, will reset ALL the colors, schemes, and/or fonts of Zip Control back to those that are active the next time Zip Control is started. This choice is located in the Settings notebook. ═══ 13. Trouble Shooting ═══ Zip Control Error Messages Most users find Zip Control easy to use and license the software without reporting any problems. However, other users may have a different operating environment or may use Zip Control with zip files where Zip.exe or UnZip.exe send Zip Control error messages. In those cases, the ZC users will see a general error message from ZC which offers to display the error message reported by Zip.exe or UnZip.exe. It further offers to display additional information which you may wish to report to RPF Software. At that point RPF Software duplicates the problem and, if the problem is caused by Zip Control, makes the necessary software repairs to properly handle the problem. A new version of ZC is then made available. When the error message offers to display the specific error message as reported by Zip.exe or UnZip.exe, this alerts alert you to a possible problem with the zip file with which you are working. Prior to contacting RPF Software, you may wish to try the same action (zip or unzip) from the command line with either Zip.exe or UnZip.exe, as appropriate, to see if the same error is reported. Since this test will be done without Zip Control, if the error message occurs, the problem is then narrowed to either a problem with the zip file itself or a problem with Zip.exe or UnZip.exe. You may need to refer to the appropriate Zip.doc or UnZip.doc to determine the correct syntax for the command line programs. Contact Information for Support RPF Software P.O. Box 420457 Atlanta, GA 30342 CompuServe: 71660,535 Internet: 71660.535@compuserve.com or RPFSoft@atlanta.com (use the Internet address above for Prodigy, AOL, MCIMAIL, Internet) FAX: 404.250.0282 ═══ 14. Order Information ═══ Order Form To review (and print or copy to clipboard) the Zip Control Order Form. Where To Order To see a list of organizations from which Zip Control may be ordered. ═══ Progress ═══ Some Zip and UnZip operations may be time consuming. For these, Zip Control displays a small progress window. Depending on the information that is available to Zip Control, the progress window will display either the % complete or elapsed time. If the "Minimize while processing" check box is checked, all of Zip Control will be minimized, with just the progress window keeping you informed of progress. The "Minimize while processing" check box may be checked at any time. If it is unchecked, Zip Control restores itself from its minimized state. The progress window remains. If the Cancel button is pressed, Zip Control will interrupt the UnZip, Zip, or other processing almost immediately. See also Save colors/fonts ═══ 15. Keys Help ═══ Keys Help for the main Zip Control window Alt-A Add files to an archive file (.zip). Alt-Shift-A Sort Zip File Contents--Ascending. Alt-C Display the Comments window. Alt-D Delete selected (highlighted) files from the .zip file. Ctrl-D Delete the current .zip file from the disk. Alt-Shift-D Sort Zip File Contents--date+name+path. Alt-E Unselect all files in the list box. Alt-Shift-E Sort Zip File Contents--ext+name+date+path Ctrl-F Find (and highlight) a file name (or names) in the .zip file which contain(s) a specific item of text. Alt-G Open Settings notebook. Alt-H Help. Ctrl-H Toggle between the full Zip Control main window and the expert "Hide buttons" main window. Alt-I Toggle Extended/Multiple selection for the list box. Alt-L Select all files in the list box. Alt-M Toggle AutoComments. Ctrl-M Move the .zip file to the repository directory. Alt-N Create a New (empty) .zip file. Alt-Shift-N Sort Zip File Contents--name+date+path. Alt-O Open an existing .zip file. Alt-Shift-O Sort Zip File Contents--none (original .zip order). Alt-P Print selected (highlighted) file(s). Alt-Shift-P Sort Zip File Contents--path+name+date. Alt-Q QwikEval--Test, extract, scan, re-zip. Alt-R Show the Product Information window. Alt-S Search one or more drives for .zip files. Alt-Shift-S Sort Zip File Contents. Ctrl-S Scan the zip file contents for viruses. Alt-T Save To--Save a copy of the current .zip file to a new .zip file name. Ctrl-T Test the currently open zip file, using the built in UnZip -t capability. Alt-U UnZip files from the .zip file to a target directory. Alt-V View selected (highlighted) file(s). Alt-W Toggle SmartView. Ctrl-Z Create a .exe (self-extracting) file from a .zip file. Ctrl-/ Select (highlight) ALL files in the main window list box. Ctrl-\ UnSelect (unhighlight) ALL files in the main window list box. Alt-X Exit Zip Control. F3 Exit Zip Control. ═══ Virus Scan Program Parameters ═══ When entering the virus scan program path and name in the Settings notebook, it may be desirable to use the Custom settings. Should a decision be made to use the Custom settings, unpredictable results may occur, as Zip Control cannot anticipate (and, therefore, check for) all possible settings and possible errors (syntax, etc.) that may occur. If the McAfee OS/2 virus scanner (OS2SCAN.EXE) or the IBM AntiVirus scanner (IBMAVSP.EXE) is to be used, then the default settings are fine and there would normally be no need to use the Custom settings, unless there is a desire to override the built-in, default settings for those virus scanners. The default settings for the above virus scanners are:  McAfee /ALL /SUB /APPEND /RPTCOR /RPTERR /REPORT $$$  IBM AntiVirus -ALLFILES -LOG$$$ -COPENERR -CERR -NREP -NWIPE -NFSCAN See the McAfee and IBM AntiVirus user manuals for more information on the above parameters. The "$$$" is described below. To use another virus scanner, or to use the McAfee or IBM AntiVirus scanners with other than the above default settings, Custom settings may be used. An alternative to Custom settings may be environment variables in the config.sys file if the virus scanner supports them. The full path (drive:\directory\filename) for the virus scanner should be entered on the Settings notebook, Programs page, not in the Custom window. Zip Control creates a temporary virus scan report file which will be deleted after it is displayed. If there is a need to retain the virus scan report file, enter the full path (drive:\directory\filename) for the report file in the Report File entry field. Otherwise, leave it blank. If a report file name is entered as above, it will be assumed the file should be 'appended' to, i.e., Zip Control will still send the virus scan report to its normal temporary report file, but, after display of the report, will append the temporary file to the more permanent report file specified in the above entry field. This would allow the relatively permanent recording of scan history. It may be desirable to periodically delete the 'permanent' report file if its size grows large enough to negatively affect available disk space. If desired, enter virus scanner program parameters in the "Virus Scan Program Parameters (use $$$ for report file name)" entry field. See the virus scanner user manual for appropriate parameters to enter. One of the parameters entered should be one which will send the results of the virus scan to a report file. Instead of entering the report file name, enter the special symbol '$$$' (without the quotes). In other words, if the normal syntax for specifying a report file name would be similar to /REPORT c:\virus\myreport.rpt enter instead /REPORT $$$ (IBM AntiVirus uses the -LOGc:\virus\myreport.rpt syntax, so enter -LOG$$$ instead.) The '$$$' will allow Zip Control to substitute its temporary report file name at the location of the '$$$', to display the virus scan report, optionally append the generated virus report to the user-specified report file (if any), and then delete its temporary file. Do not enter the virus scan program name (or path, etc.) in the entry field. It is entered on the Settings, Programs page. To restore the virus scanner parameters to the appropriate McAfee or IBM AntiVirus default, blank (remove) all the information in the Parameters entry field. ═══ Drag and Drop Help ═══ Dragging Files TO Zip Control from Desktop or a Folder To Open a zip file by dragging and dropping it on the Zip Control list box, hold both the Ctrl and Shift keys down immediately prior to releasing the mouse button. To Add file(s) and/or directory(ies) to an already open zip file or to an empty Zip Control list box, the state of the Ctrl and Shift keys will affect whether and how path (drive:\directory) information will be stored in the zip file.  Neither Ctrl nor Shift keys depressed when mouse button is released--no path for the immediate files but will store paths for any files in subdirectories.  Only the Shift key depressed when mouse button is released--same as above.  Only the Ctrl key depressed when mouse button is released--the path for the immediate files and for files in subdirectories will be stored in the zip file.  Both Ctrl and Shift keys are depressed when the mouse button is released and one or more directories are being Added to the zip file--no paths will be stored and no subdirectories will be stored. Dragging Files FROM Zip Control to Desktop or a Folder  If the file name over which the RMB drag is begun is highlighted, then all the highlighted files will be copied to the target folder.  If the file that is dragged was not highlighted (others may have been highlighted), only the file over which the RMB drag was begun will be copied to the target folder.  If a drag is begun over "white space", then all highlighted (if any) files will be copied to the target folder. ═══ 16. Command Line Parameters ═══ Command Line Parameters Command line parameters may be used to alter the operation of Zip Control. The parameters may be passed to Zip Control when started from an OS/2 command line or may be entered in the "Parameters" field of the Zip Control program reference object on the OS/2 Desktop. /U AutoUnZip: Set up a separate program reference object to be used as the target when dragging zip files from the Desktop or from the Drives folders. Zip files dragged to this object will be unzipped according to the user settings of the Zip Control INI file, without opening any Zip Control windows. This option may be combined with the /I INI file command line parameter (see below) to access custom settings in a different INI file from the one used by normal Zip Control operations. For example, it may be helpful to use a Zip Control INI file containing a setting which defines the target drive and directory to be a subdirectory of the download directory, with the subdirectory created and named by Zip Control to be the same as the zip file name (without the .zip extension). See the on-line help for the Settings notebook, Options-UnZip page and Paths page. /I=drive:\directory\filename.ini INI File: The default INI file used by Zip Control is named ZipCntrl.ini and is expected to be in the same directory as ZipCntrl.exe. This parameter permits establishing one or more alternate INI files for Zip Control's use. The alternate INI file may contain different zipping, unzipping, paths, program names, etc., as set by the options selected in the Settings notebook. Or this capability could be used in a networked environment to enable having one copy of Zip Control on a network drive, with each individual user's preferences stored in a personal, local (or network) INI file. It is recommended that the full drive, directory, and INI filename be used with the /I parameter. Example: /I=C:\INIFILES\Custom.ini /D Debug: This option turns on "logging" for information about SYSnnnn type errors. When this option is defined in the parameters passed to Zip Control, the file "debug.log" will be placed in the directory in which the Zip Control .ini file resides. This file is a text file which may be included in an email, letter, or fax to RPF Software to assist in solving SYSnnnn type errors associated with Zip Control. To begin the creation of the debug.log file, just place "/D" (without the quotes) in the parameters field of the Zip Control program object or run Zip Control from the command line, passing "/D" as a parameter. Example: /D /Z1 ZipVersionDate1: This option disables setting the thread priority to "idle" for the thread that attempts to determine the Version and Date of the Zip.exe program. The default (no /Zn parameter) is to set the thread priority to "idle." Some versions of OS/2 have had difficulty (stalls, thread starvation) with the "idle" thread priority. This parameter is provided to leave the thread at the default "regular" priority rather than Zip Control setting it to "idle." To leave the thread priority at "regular" rather than forcing it to "idle," just place "/Z1" (without the quotes) in the parameters field of the Zip Control program object or run Zip Control from the command line, passing "/Z1" as a parameter. Example: /Z1 /Z2 ZipVersionDate2: This option eliminates the thread that attempts to determine the Version and Date of the Zip.exe program. If the default, no /Zn parameter, causes Zip Control problems with certain versions of OS/2, and if /Z1 does not provide satisfactory performance on initial startup and loading of a .zip file, /Z2 may be used to completely eliminate the thread that determines the Version and Date of Zip.exe. This information is primarily for diagnostic and display purposes and can be omitted without harm. To eliminate the Zip.exe Version and Date determination, just place "/Z2" (without the quotes) in the parameters field of the Zip Control program object or run Zip Control from the command line, passing "/Z2" as a parameter. Example: /Z2 ═══ Order Form ═══ RPF Zip Control(TM) Copyright 1993-1996 RPF Software ALL RIGHTS RESERVED -------------------------- Order Form -------------------------------- Type of License VERSION 2.4.2 Qty Each Total -------------- ------------- ----- ---- ------- Single User License Keys _____ $35 $______ Unlimited User License Keys (at one site) _____ $250 $______ Unlimited User License Keys (multi-site) _____ $975 $______ Single User License Key Paks* _____ $46 $______ *includes License Key, diskettes, plus $6 S&H ----------------------- Licensee Information ------------------------- (use copies of this form for multiple single/site licenses) User/Contact Name ____________________________________________________ Company Name ____________________________________________________ Address ____________________________________________________ ____________________________________________________ City _____________________________ State/Province____________________ Country ___________________________ Zip/Postal Code___________________ Telephone _________________________ FAX ______________________________ Email ID _____________________________________________________________ Alternate Email ID ___________________________________________________ Where I found Zip Control ____________________________________________ (so we can ensure we place the latest copies of ZC there) ------------------------------ Payment ------------------------------- See "Where To Order" for the various methods of payment and organizations from which Zip Control may be ordered. In return for the license fee, you will be sent a License Key to enter on the Product Information screen. This will disable the "Unlicensed Evaluation Copy" message. Most importantly, acquiring a license will mean that you have a legal license to use the software AND you are supporting OS/2 software development. ═══ Where To Order ═══ RPF Software ------------ Attn: Richard Fortson RPF Software P.O. Box 420457 Atlanta, GA 30342 * US checks in $US * US or American Express or International money orders in $US. CompuServe ---------- GO SWREG #1373 Single User #5502 Single Site #5573 Multi-Site * Appears on next CompuServe bill. Indelible Blue, Inc. -------------------- Indelible Blue, Inc. P.O. Box 31306 Raleigh, NC 27662 800.776.8284 (Orders) 919.878.9700 (Inquiries) 919.878.7479 (Fax) http://www.indelible-blue.com/ib CompuServe Mail 76256,3334 and International Distributors * credit cards, checks, wire transfers BMT Micro --------- BMT Micro PO Box 15016 Wilmington, NC 28408 (mail) 800.414.4268, 910.791.7052 (voice) 800.346.1672, 910.350.2937 (fax) orders@bmtmicro.com (Internet) telnet@bmtmicro.com http://www.bmtmicro.com 910.799.0923 (BBS) CompuServe Mail 74031,307 * credit cards, checks, money orders, currency, Deutsche Bank deposits, etc. Pete Norloff's OS/2 Shareware BBS --------------------------------- 703.385.4325 * credit cards.